home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / CRS / crs58.d81 / geoglb3.prg (.txt) < prev    next >
GEOS ConVerT  |  2009-10-10  |  9KB  |  123 lines

  1. geoglobe docs
  2. PRG formatted GEOS file V1.0
  3. NX1000
  4. `.dbg
  5. GEOGLOBE
  6. BLASTER'S CONVERTER V2.5
  7. maphdr.rel
  8. mapzones.rel
  9. Write Image V2.0
  10. geoWrite    V2.1
  11. geoGLOBE
  12. David B. Ferguson
  13. Copyright 1990
  14. "geoGLOBE" is a world distance and time zone calculator. You enter the latitude, longitude and time zone of a location...and "geoGLOBE" tells you how far that location is from wherever you have set your "home" location, the time difference between the two locations and the actual time in both locations. In addition, a flashing dot on the map indicates the approximate location.
  15. Some Terms
  16. "home city" is the location you choose to calculate all other data from. When you first run "geoGLOBE", the home city will be Hughson, my home town.
  17. "current city" is the city currently displayed in the information box at the bottom of the screen.
  18. A "city", of course, can be any location.
  19. "global cities" is the data file which can data on up to 195 locations.
  20. How You Make It Go
  21. Double click the "geoGLOBE" or "global cities" icon. Don't load this from "geoWIZARD". 
  22. Then This Happens
  23. "geoGLOBE" runs and automatically loads "global cities".
  24. The "geoGLOBE" screen appears. There is a two entry menu, a map of the world, and an information box which displays the data for the first city in the file. The home city is always the first city in the file.
  25. GEOS menu
  26.      
  27. Credits
  28.  allows you to see the names of those who are responsible (even though they dodn't know it) for this.
  29.      
  30.  lets you QUIT. Quitting automatically saves the "global cities" file.
  31. CITY menu
  32.          
  33. Add City
  34.  allows you to add new locations. There is a limit of about 195 cities.
  35.      
  36. Erase City
  37.  erases the currently displayed city. If you accidentally erase a city, go to Find City (see below) and substitute "***" for the first three letters of the city. But do this right away. New cities are placed where old cities were.
  38.              
  39. Set Home
  40.  makes the currently displayed city become the new home city. All distances and time differences are now calculated from this city. 
  41.      
  42. Find City
  43.  finds a city. (Duh!) You must have everything right. "Washington", for example, will not find the entry "Washington, D.C.".
  44. Each of these entries, except Credits, has a keyboard entry. 
  45.      Q=Quit
  46.      A=Add City
  47.      E=Erase City
  48.      [home]=Set Home
  49.      F=Find City.
  50. More About Add City
  51. When you select this, you will be asked to enter several pieces of data.
  52. 1) The location name up to 20 characters. No rules here except you can enter a name starti
  53. More About Add City
  54. When you select this, you will be asked to enter several pieces of data.
  55. 1) The 
  56. location name
  57.  up to 20 characters. No rules here except you can enter a name starting with a "*". Who the heck would?!!
  58. 2) The 
  59. latitude
  60.  of the location in degrees and minutes. It must have the following format:
  61. dd:mmD
  62. where dd=degrees from 0 to 89
  63.       mm=minutes from 0 to 59
  64.       D = N(n) or S(s)
  65. 3) The 
  66. longitude
  67.  of your location in the following format:
  68. ddd:mm:D
  69. where ddd=degrees from 0 to 179
  70.       mm=minutes from 0 to 59
  71.       D= E(e) or W(w)
  72. (NOTE: For latitude and longitude you may delete any leading zeros.)
  73. Time Zone
  74.  relative to GMT (Greenwich Mean Time). Use the following format:
  75.  Shh:mm
  76. where S= + or - ; + is East of GMT, - is West
  77.       hh=hours between 0 and 12
  78.       mm=minutes--must be 00, 15, 30, 45
  79. If yo make an error in 2, 3, or 4 above, you will see a general error warning DB. Click OK and re-enter data.
  80. ld re-enter data.
  81. Set Home
  82.      F=Find City.
  83. The "geoGLOBE" screen appears. There is a two entry menu, a map of the world, and an information box which displays the data for the first city in the file. The home city is always the first c
  84. The Information Box
  85. The four pieces of data you just entered appear along with several calculated pieces of information:
  86.  is the distance in statute miles between the home city and the currently displayed city. This is by great circle route calculations, an "as-the-crow-flies" measurement. 
  87.  is the time difference based on your time zone entry. A "+" difference means you would ADD the difference to the home city's time. A "-" means you would subtract the difference.
  88.  is the computer's clock.
  89. . is the time in the city you are currently viewing. 
  90. You can change data in the information box by clicking on the CITY, LAT, LON and ZONE.
  91. Clicking on the globe icon will display the next city. This is circular only in one direction. The home city follows the last city.
  92. You can also use the following keyboard entries:
  93.      C=CITY
  94.      [crsr dn]=LAT
  95.      [crsr right]=LON
  96.      G=Next City (G for Globe)
  97.      Z=ZONE
  98. Changing LAT or LON will update DIST. Changing ZONE will update DIFF and CURRENT.
  99. The MAP
  100. A flashing box on the map will indicate the approximate location of the currently displayed city. If the location you are displaying isn't on the map, there will be no flash.
  101. That's about it...
  102. But read on if you want some more technical information.
  103. More Stuff (Some Technical; Some Not)
  104. 1) The map is not proportionally correct. The position of the flashing box is calculated by use of look-up tables. I have tried to make the locations as accurate as possible, but don't base a major homework assignemt on them!
  105. 2) You can't access any desk accessories because I hope that this will someday 
  106.  a DA of its own.
  107. 3) The reason you can't enter time zones with minutes other than 00,15,30 and 45 is that time zones and differences are looked up on a table of times ranging from +12:00 to -11:45.
  108. 4) Time zones are stored in the data file both as the actual data entry (+01:00) and as a number from the time look-up table mentioned above.
  109. 5) Differences are only stored by their look-up table number. This way, when the home city changes or the time zone changes, the only data in each city record that has to be changed is that number.
  110. 6) Latitude and longitude are stored in the data file broken down into strings. For example, a city with 37:36n and 120:52w would be stored as:
  111. "+37","+36","-120","-52"
  112. This makes computation of the distances much easier.
  113. 7) After Add City, Find City, clicking the globe, or changing LAT or LON, you will see a rapid flickering of the cursor. What you are seeing is the switching back and forth from the GEOS kernal and the C64 kernal. This is, of course, the floating point math routines at work, calculating the distances. This method of accessing the C64 routines was developed by Robert Knop, who graciously uploaded them for all of us to use.
  114. 8) The great circle distance calculation routine is a fairly common formula which I downloaded in basic and converted to ml and then to GEOS. There are two test locations for the basic program which I have used to test mine. They work. So do my short distance tests. This program may not be perfect, but it's pretty damn close.
  115. If you want to test for yourself, find either "Yacht (Test 1)" or "Cornwall (Test 2)". Make either one of these the "home" location, then go to the other one. The distance should read 3671.
  116. 9) The file included with this has about thirty locations on it. Most of the time zones are right, but I had to guess on a few. I don't have a really good time zone map.
  117. Dave Ferguson
  118. DiBieF 
  119. geoGLOBE
  120. David B. Ferguson
  121. Copyright 1990
  122. "geoGLOBE" is a world distance and time zone calculator. You enter the latitude, longitude and time zone of a loc
  123.